home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #2 / Monster Media No. 2 (Monster Media)(1994).ISO / renegade / tcr110b2.zip / TCR.DOC < prev    next >
Text File  |  1994-06-02  |  42KB  |  881 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.          |  TCR v1.10 Beta 02 Documentation
  11.          |
  12.          |  Automated Call Return Door
  13.          |
  14.          |  Copyright 1993,1994 by Tim Strike and Forbidden Knights Systems.
  15.          |  Released on June 2nd, 1994.
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.                                  ____________
  25.  
  26.                                  INTRODUCTION
  27.                                  ____________
  28.  
  29.              This program won't mean a lot to many people; but to those of
  30.         you have have need of something that calls the user back without
  31.         doing anything else will find this door very useful.  It may also
  32.         come in handy as a generic callback door for ANY BBS software that
  33.         can internally or externally process a success file.
  34.  
  35.              TCR is based on the Callback Validator type system, except that
  36.         TCR does absolutely no "validating".  The concept of TCR was first
  37.         established when a few friends were looking for a door that could be
  38.         setup to do a return call on certain users.  In some areas, calls one
  39.         way are long distance, yet the return call is a local call.
  40.         Something like this:
  41.  
  42.                        Point1 ------(LD)------> Point2
  43.                               <---(Local)------
  44.  
  45.              The idea was to get a door going for the Point2 system, where
  46.         the Point1 system would start the call, and Point2 would then
  47.         callback so that no charges (except the initial dialup) are incurred
  48.         by the Point1 system.
  49.  
  50.              So what's the point of the entire thing?  Well, imagine that
  51.         Point2 was a BBS, and Point1 was a slew of callers from one specific
  52.         area.  Normally, Point2 might find the interest in the BBS diluted
  53.         because callers are unwilling to take the costly plunge.  TCR is an
  54.         attempt at a solution for systems who find themselves in the Point2
  55.         situation with callers in the Point1 area unwilling to commit.
  56.  
  57.              As an extension to this idea, TCR creates a "success" file.
  58.         If the BBS program processes this success file as successful
  59.         validation, TCR can be turned into a generic callback validation
  60.         system.  The only worries of the various programmers/BBS authors
  61.         is to process this file, and validate the user accordingly.  TCR
  62.         does all the logistical work of calling the user, keeping logs,
  63.         etc...
  64.  
  65.  
  66.                                  ___________
  67.  
  68.                                  BETA STAGES
  69.                                  ___________
  70.  
  71.              This program is still in it's beta stages.  Since this
  72.         program has direct interaction with the modem and it's result
  73.         codes, there are likely to be many problems.  In order to iron out
  74.         as many of these bugs as possible, it was decided that a wide beta
  75.         version would be distributed.  This wide beta version will
  76.         increase in beta revisions until it is suitable for release.
  77.  
  78.              Testing has been continually run with the two modems that I
  79.         own, but there are bound to be other problems that arise with
  80.         different sets.  TCR may not run prefectly until a standard
  81.         version is released, and even then, it may not run as smooth as
  82.         silk. ;)
  83.  
  84.              Please report any bugs that you may discover.
  85.  
  86.  
  87.                               _________________
  88.  
  89.                               PROGRAM OPERATION
  90.                               _________________
  91.  
  92.              TCR requires the DOOR.SYS file to be in the current operating
  93.         directory.  If you are running TCR from a different directory,
  94.         make sure that somehow the DOOR.SYS file gets copied into the TCR
  95.         executable directory or specify the command line /D:<path> which 
  96.         will be used to load the DOOR.SYS file from that path.
  97.  
  98.              PLEASE NOTE THAT THIS DOOR WILL ONLY WORK AS WELL AS YOU SET
  99.         IT UP.  YOU MUST CHANGE THE .DAT FILES.  YOU MUST CHANGE THE MODEM
  100.         CONFIGURATION.  And that's likely not all of it.  If you have any
  101.         problems getting this door to work, please drop me a line.
  102.  
  103.  
  104.                                    _______
  105.  
  106.                                    SAMPLES
  107.                                    _______
  108.  
  109.              TCR has three data files that is uses to parse/process numbers.
  110.         TCR-LOCK.DAT is a file that locks out numbers from the callback
  111.         process.  TCR-DIAL.DAT is a file which is used to trim the phone
  112.         number from the 1-###-###-### format to something that is dialable.
  113.         The TCR-LONG.DAT file contains a list of all the numbers that you
  114.         will call back long distance.  If you do not put anything in this
  115.         file, even if you have long distance calls set to YES, they will
  116.         not be processed.
  117.  
  118.              TCR also uses another data file, TCR-CALL.DAT to store which
  119.         users it has called back, their original numbers, names, the
  120.         dialed number, password attempts and date/time.  This file has a
  121.         specific format which is listed in the sample file; it will change
  122.         as users become validated, and their numbers get added to the data
  123.         file.
  124.  
  125.              If you do NOT have these files, then TCR will operate as
  126.         normal; however you will likely end up dialing numbers you don't
  127.         want to dial.  The samples are in the file called SAMPLES.ZIP, and
  128.         you should UNZIP that file into your TCR directory and read and
  129.         change the files.  It is very important that these files be setup
  130.         for YOUR area and YOUR setup, as my sample setup files work for my
  131.         system only!
  132.  
  133.  
  134.                            ____________________
  135.  
  136.                            INSTALLATION (BASIC)
  137.                            ____________________
  138.  
  139.              Now, let's get some examples down so we can get TCR installed
  140.         on your board, and running for your users.
  141.  
  142.  
  143.         |-| PART 1 - Creating Neccessary Files |---------------------------|
  144.  
  145.              Copy the TCR.EXE file into a directory you wish to use as your
  146.         TCR directory (this could be your main BBS directory if you so
  147.         choose).
  148.  
  149.              PKUNZIP the file SAMPLES.ZIP into your TCR directory, and load
  150.         them into your text editor and change them accordingly (descriptions
  151.         are listed inside these two files).  It is very important that you
  152.         change these files.
  153.  
  154.              Run TCR SETUP to change the defaults and setup your modem
  155.         information.  It is very important that you do this; make sure the
  156.         init strings you supply will cause the modem to work in VERBOSE
  157.         description mode.  See the section on SETUP for further
  158.         information on the many variables tha SETUP offers.
  159.  
  160.              PKUNZIP the file TEXT.ZIP into the directory you defined in the
  161.         TCR SETUP screens as your "text" directory.  This could be your TCR
  162.         directory if you have a seperate TCR directory, or perhaps your TEXT
  163.         directory for your BBS software.
  164.  
  165.         |-| PART 2 - BBS Installation |------------------------------------|
  166.  
  167.              Next you need to install it into your BBS.  Setup your BBS to
  168.         create the dropfile DOOR.SYS, and then run TCR -- you could also make
  169.         it run a batch file instead, something like:
  170.  
  171.               @ECHO OFF
  172.               CD\BBS\TCR
  173.               TCR /D:<path to DOOR.SYS>
  174.               CD\BBS
  175.               EXIT
  176.  
  177.         Please note that YOU should restrict access to the door through your
  178.         menus.  If you only want people in certain locations to be called
  179.         back, create a flag for them and control the menu access with that
  180.         flag.
  181.  
  182.               (this example for Telegard/Renegade)
  183.  
  184.               Long Description .. : (R)eturn Call - System Calls You Back
  185.               Short Description . : (R)eturn Call
  186.               Command letters ... : R
  187.               ACS ............... : s25fA
  188.                                     ^- Can be anything -- I suggest that
  189.                                        you restrict ACS to those people that
  190.                                        you want to use the door with an AR
  191.                                        flag.
  192.               Keys .............. : DG
  193.               MStr .............. : TCR.BAT
  194.  
  195.              I am only familiar with Telegard and Renegade, and as such I can
  196.         not provide any further setup examples to cover installations into
  197.         all BBS packages.  If you install TCR into other programs besides
  198.         Telegard or Renegade, please netmail me with the instructions so that
  199.         I can add them to future documentation.
  200.  
  201.  
  202.                              _______________
  203.  
  204.                              "SETUP" COMMAND
  205.                              _______________
  206.  
  207.              The setup option of TCR can be invoked by simply typing "TCR
  208.         SETUP" on the command line.  Once this is done, a screen similar
  209.         to the following should appear:
  210.  
  211.             1. Text path     : C:\TCR\
  212.             2. Log file      : C:\TCR\TCR.LOG
  213.             3. # Changes     : Yes
  214.             4. Boot Callers  : Yes
  215.             5. Attempts      : 3
  216.             6. Waiting Time  : 5 seconds
  217.             7. Connect Time  : 30 seconds
  218.             8. Random Pass   : Yes
  219.             9. User Pass     : Yes
  220.             0. Pass Attempts : 3
  221.             A. Lock Previous : No
  222.             B. BBS Name      : The Call Return Door
  223.  
  224.             L. Long Distance Handling
  225.             M. Modem Setup
  226.  
  227.         Option (1) sets the textfile directory.  This is where you unzipped
  228.         the TEXT.ZIP file which contains the TCR text files.
  229.  
  230.         Option (2) sets the logfile that will be kept by TCR of all the
  231.         activities that occur in the door.
  232.  
  233.         Option (3) sets if the user is allowed to input alternate numbers.
  234.         If this option is set to NO, the only phone numbers available will be
  235.         those given in the DOOR.SYS file -- if those two numbers are the
  236.         same, the user will be given one option only.  If YES, the number the
  237.         user inputs will be logged.
  238.  
  239.         Option (4) sets the Automated Call Boot.  This option will detect NO
  240.         DIAL TONE and RING strings during the callback.  if this option is
  241.         set to YES, then the phone will be answered, and a message will be
  242.         sent to the connecting user, then TCR will hangup.  This allows the
  243.         call return procedure to continue as normal.  IT IS HIGHLY
  244.         RECOMMENDED THAT THIS OPTION BE SET TO YES.
  245.  
  246.         Option (5) sets the number of callback attempts that should be made.
  247.         If the user doesn't connect in the specified time, TCR will try again
  248.         until it has tried this amount.
  249.  
  250.         Option (6) sets the waiting time before the call return starts.
  251.         After the user is disconnected, it will pause until this time limit
  252.         has been reached, then initialize the modem and start the call
  253.         return.
  254.  
  255.         Option (7) sets the waiting time AFTER the number has been dialed.
  256.         If no connection is made in this time, the loop will end.  This
  257.         should be set to your S7= setting (at minimum).
  258.  
  259.         Option (8) sets if TCR should use a random password to verify that
  260.         the user being called back is the user that was on before.
  261.  
  262.         Option (9) sets if TCR should use the user password to verify that
  263.         the user being called back is the user that was on before.
  264.  
  265.         Option (0) sets the number of times the user can fail the password.
  266.         If the user fails this number of times, they are hungup.
  267.  
  268.         Option (A) sets if TCR should call a number that is has called
  269.         before. It is suggested that this option be NO, but for some SysOps
  270.         the option has been installed.  If you are going to be using this
  271.         door in the call return, not the callback verify mode, then this
  272.         option should definately be set to NO.
  273.  
  274.         Option (B) sets the BBS name.  This is displayed to the user when
  275.         calling the user back, or when answering the phone in callboot
  276.         mode.
  277.  
  278.         Option (L) sets the long distance setup.  When you hit this option, a
  279.         screen similar to the following should appear:
  280.  
  281.            1. Allow LD     : No
  282.            2. Hangup after : Yes
  283.  
  284.                              Morning                 Afternoon
  285.                              1                   1 1 1                   1 1
  286.                              2.1.2.3.4.5.6.7.8.9.0.1.2.1.2.3.4.5.6.7.8.9.0.1.
  287.  
  288.            A. Sunday       : XXXXXXXX··XXX··························XXXXXXXXX
  289.            B. Monday       : XXXXXX····XXX·······························XXXX
  290.            C. Tuesday      : XXXXXX····XXX·······························XXXX
  291.            D. Wednesday    : XXXXXX····XXX·······························XXXX
  292.            E. Thursday     : XXXXXX····XXX·······························XXXX
  293.            F. Friday       : XXXXXX····XXX·······························XXXX
  294.            G. Saturday     : XXXXXXXX··XXX·····························XXXXXX
  295.  
  296.            Option (1) sets if the door will allow LD calls.  If this option
  297.            is set to NO, any number beginning with 1- will be denied.
  298.  
  299.            Option (2) sets if the door should hangup after the LD call is
  300.            completed.  This option, for those of you who are like me, poor,
  301.            should be set to YES.  However, if your interface requires that
  302.            the user be online to work, using this option isn't possible (in
  303.            that case, it is suggested that a menu be created such that the
  304.            only exit from the menu is to hangup).
  305.  
  306.            Options (A) through (G) set the times that LD calls are allowed to
  307.            be completed.  The days Sunday through Saturday have been setup
  308.            with 48 different time slots (every 30 minutes).  If the timeslot
  309.            has an X in it, then LD calls are allowed during that period.
  310.            This allows you to setup TCR to only dial LD calls when it is
  311.            cheapest, etc...
  312.  
  313.         Option (M) [back to the main screen now] sets the modem 
  314.         configuration.  If you hit this option, a screen similar to the 
  315.         following will be displayed:
  316.  
  317.            A. Initialization : ATH0M1L0V1E0Q0X6&C1&D2
  318.            B. Dialing        : ATDT
  319.            C. Answering      : ATA
  320.  
  321.            1. Connect        : CONNECT
  322.            2. Busy           : BUSY
  323.            3. Error          : ERROR
  324.            4. Okay           : OK
  325.            5. Ring           : RING
  326.            6. Voice          : VOICE
  327.            7. No Carrier     : NO CARRIER
  328.            8. No Dial Tone   : NO DIAL TONE
  329.  
  330.            Option (A) sets the modem init string.  This should be setup for
  331.            your modem to have DROP CARRIER ON DROP OF DTR, and VERBOSE result
  332.            strings.  The rest of it you can set according to your modem, but
  333.            the above two things must be somehow included in the init string.
  334.            The default should work with most modems -- mine's a USR 16.8 DS
  335.            and it works great.
  336.  
  337.            Option (B) sets the dialing prefix.  ATDT for Tone, ATDP for
  338.            Pulse. Anything beyond that is completely up to you.
  339.  
  340.            Option (C) sets the answering string.  If Call Boot is on, this
  341.            will be sent to the modem to answer and boot the caller.
  342.  
  343.            Options (1) through (8) set the modem response strings.  The only
  344.            thing of big note is that the CONNECT string should not contain
  345.            any of the baud rates, but only a keyword in the string that is
  346.            unique to all the "connect" strings of your modem. The defaults
  347.            should be fine for most modems.
  348.  
  349.  
  350.  
  351.                                   __________
  352.  
  353.                                   TEXT FILES
  354.                                   __________
  355.  
  356.              TCR uses very few prompts in the actual program.  Most of the
  357.         instructions are provided with text files that you can configure. The
  358.         samples are provided in the file TEXT.ZIP and have everything that
  359.         you should need to say in them.
  360.  
  361.              Only .ASC files have been provided, but TCR will display .ANS
  362.         files to ANSI callers, and .AVT files to Avatar callers.  If you wish
  363.         to create these files, you can do so at your own discretion.
  364.  
  365.              TCR-HEAD     .ASC .ANS .AVT   File is displayed as a header
  366.                                             file before any interaction with
  367.                                             the user is started.
  368.  
  369.              TCR-HELP     .ASC .ANS .AVT   File is displayed if user answers
  370.                                             YES to the help question.  This
  371.                                             file could contain some answering
  372.                                             information, what's going to
  373.                                             happen, etc...
  374.  
  375.              TCR-LOCK     .ASC .ANS .AVT   File is displayed if the users
  376.                                             number is listed in the
  377.                                             TCR-LOCK.DAT data file.  The door
  378.                                             will then exit.
  379.  
  380.              TCR-HANG     .ASC .ANS .AVT   File is displayed just before TCR
  381.                                             drops the carrier to call them
  382.                                             back.  Good for short reminders.
  383.  
  384.              TCR-OK       .ASC .ANS .AVT   File is displayed after successful
  385.                                             TCR call return (and after
  386.                                             passwords have been input
  387.                                             correctly).
  388.  
  389.              TCR-BAD      .ASC .ANS .AVT   File is displayed after bad
  390.                                             password attempts, just before
  391.                                             disconnecting the user.
  392.  
  393.              TCR-LONG     .ASC .ANS .AVT   File will be displayed to long
  394.                                             distance (1-) users if LD calling
  395.                                             is turned off or if their number
  396.                                             fails the LD check.
  397.  
  398.              TNC-TIME     .ASC .ANS .AVT   File will be displayed to long
  399.                                             distance (1-) users if current
  400.                                             time does not fall within a LD
  401.                                             calling window (LD calls must
  402.                                             also be allowed).
  403.  
  404.              TCR-BUSY     .ASC             File is displayed if an incoming
  405.                                             call is received during a return
  406.                                             call session.  TCR will answer,
  407.                                             display the BUSY file, and then
  408.                                             hangup and continue with the
  409.                                             return call.
  410.  
  411.  
  412.                           _________________________
  413.  
  414.                           SETUP: ONE-WAY LD SYSTEMS
  415.                           _________________________
  416.  
  417.              The concept behind this setup for TCR is simple, and for the
  418.         most part was largely explained during the introduction and initial
  419.         setup.  Once you have the "BASIC" setup installed, you can continue
  420.         from there.
  421.  
  422.              One-way LD systems occur in remote calling areas which have
  423.         "extended" service because they are in a remote area.  These remote
  424.         areas have been provided with free calling into the main city, but
  425.         the call going the other way FROM the main city is long distance.
  426.         This limits the availability of the system to main city callers.  The
  427.         SysOp of such a system can install a return-dialer (TCR) which will
  428.         call the user back.  The call then originates from the remote area,
  429.         and is free of cost to the user (save the initial dialup charge of
  430.         perhaps 50 cents).
  431.  
  432.              (1) Password checking isn't neccessarily required in this mode.
  433.                  Since the idea is to setup the door for callers who are in
  434.                  the main city, calling them back every day, and having to do
  435.                  double password checks for every logon could become very
  436.                  annoying.  It is suggested that both the RANDOM password and
  437.                  USER password checks are turned off.
  438.  
  439.              (2) The lock previous option should also be OFF.  The door
  440.                  wouldn't work as intended if this option is on, because the
  441.                  user would be able to use the door once, and then never
  442.                  again.  Set to NO and leave at NO. ;)
  443.  
  444.              (3) The # Changes field is a matter of personal opinion.  I
  445.                  personally would choose to put the user's phone number into
  446.                  the USER RECORD, lock it there, and allow no number changes
  447.                  in TCR.  This would result in quicker response time of the
  448.                  system dialing the user back.
  449.  
  450.         There are obviously other things that will need to be checked.  The
  451.         text files should be changed accordingly, so that mention of
  452.         validation/password checks, etc are removed depending on how the door
  453.         has been setup.  Change these files before putting the door online.
  454.  
  455.         That's more or less it.  Since I don't run this type of system (live
  456.         in the main city) I'm not sure of all the intricacies of this setup.
  457.         If there are any errors or problems of concern, please feel free to
  458.         contact me.
  459.  
  460.  
  461.                              ____________________
  462.  
  463.                              SETUP: CALLBACK DOOR
  464.                              ____________________
  465.  
  466.              The concept behind this setup is a little different.  First, it
  467.         requires more software and a little more work.  However, the
  468.         reason that TCR was made into such a portable system was so that
  469.         it could easily be moved from BBS to BBS, allowing door authors to
  470.         quickly interface TCR to the BBS with minimal effort.
  471.  
  472.              TCR should first be setup in the "BASIC" setup as described in
  473.         previous sections of this document.  Then, create a batch file that
  474.         looks like the following:
  475.  
  476.               @ECHO OFF
  477.               CD\BBS\TCR
  478.               TCR /D:<path to DOOR.SYS>
  479.               CD\BBS
  480.               EXIT
  481.  
  482.              This is a start to the entire process.  When TCR successfully
  483.         calls the user back, and they successfully input the passwords
  484.         required, then TCR will create the file SUCCESS.TCR in the current
  485.         directory.
  486.  
  487.              The next step is EXTREMELY important.  If, and ONLY if the file
  488.         SUCCESS.TCR is found, the user should be validated.  There are
  489.         several ways of going about this;
  490.  
  491.               (1) The first is to run a script and process this file if it
  492.                   exists.  This requires a very versatile script language for
  493.                   the BBS, but there are some powerful BBS script languages
  494.                   out.
  495.  
  496.               (2) The second is to get a programmer to create a VALIDATION
  497.                   program, something that will only VALIDATE the user and do
  498.                   nothing else.  This is simple in itself; the programmer
  499.                   only need know the record position or user name, etc to
  500.                   find the neccessary files to change.  Once this program is
  501.                   written (and there may be some available for your BBS
  502.                   program already), all you need to do is add a line to
  503.                   the bach file:
  504.  
  505.                   ...
  506.                   CD\BBS\TCR
  507.                   TCR /D:<path to DOOR.SYS>
  508.                -> IF EXIST SUCCESS.TCR <command>
  509.                   CD\BBS
  510.                   ...
  511.  
  512.                   The program can then take over, and validate the user. The
  513.                   basic concept is that TCR does all the work with the modem,
  514.                   and this secondary validation program does the validating.
  515.                   You can understand that 15 BBS programs can have 15
  516.                   "validation" programs, and only need one modem-user
  517.                   interface (TCR).
  518.  
  519.                   If there is no validation interface for TCR available then
  520.                   you might want to look at programming (or finding someone
  521.                   to program) the interface; since the only thing involved is
  522.                   maniuplating the data files, it makes it an easy job.
  523.  
  524.                   If someone does program an interface, I'm interested in
  525.                   carrying the interface on my system so that others can
  526.                   download it.  Please send/file attach it to me if at all
  527.                   possible.
  528.  
  529.               (3) If you can think of any other ways, great!  Let me know
  530.                   so that I can include them.
  531.  
  532.         Once TCR is interfaced to the BBS program, it'll operate without a
  533.         problem.  If you find that TCR says that the callback session was
  534.         successful, and the user's record doesn't change, the interface isn't
  535.         doing it's job -- talk to the author of the interface.
  536.  
  537.         If you are looking for interfaces and can't find one for your
  538.         particular BBS system, please drop me a line.  Interfaces for both
  539.         Telegard and Renegade have been created.  The entire development
  540.         time was about 30 minutes (spread over a few days) and encompasses
  541.         a little less then 75 lines of code.
  542.  
  543.         The process of writing a BBS interface for TCR is extremely easy
  544.         and uneventful, because all that is required is a few data file
  545.         checks and updates - nothing that requires any great knowledge of
  546.         interupts, registers, COM routines, etc - because TCR handles all
  547.         of that as the "base" program.
  548.  
  549.         This setup requires a few changes to the BASIC setup as well:
  550.  
  551.              (1) Password checking should DEFINATELY be on for this callback
  552.                  verifier mode.  One of the reasons that callback
  553.                  verifications are done are to verify the number AND that the
  554.                  user online is the user called back.  This can be done by
  555.                  checking the password.
  556.  
  557.                  The RANDOM password is an option that I highly recommend.
  558.                  It may annoy a few users who DON'T read the text they are
  559.                  sent, but that becomes their fault, not yours.  The RANDOM
  560.                  password is given right before the callback.  It's an 8
  561.                  character ASCII code (A..Z) which will be different for
  562.                  every subsequent call (26^8 total possibilities).  This
  563.                  gives a little more security that the callback is going
  564.                  to the correct user.
  565.  
  566.              (2) # Changes should be ON.  At least I leave it on, because
  567.                  some users put their voice number into the user records, and
  568.                  that's what is contained in the DOOR.SYS, and hence, what
  569.                  TCR would like to call back.  Allowing number changes will
  570.                  ensure that the user can be called back at the correct
  571.                  number (and when a number change is done, a 2 line reason
  572.                  field is input and stored in the TCR.LOG file).
  573.  
  574.              (3) Callboot should be ON.  This is an option, but it's
  575.                  highly recommended for a number of reasons.  Incoming
  576.                  calls can have a number of adverse effects on the
  577.                  callback process. If ON, the system will answer the
  578.                  phone, tell the user that a callback is in progress
  579.                  (don't call back for 5 minutes!) and then continue with
  580.                  the original process of dialing the person back.
  581.  
  582.         And that's more or less it.  The callback verifier/validator
  583.         option of TCR is more complex, because of the added interface file
  584.         which is required.  However, this provides great flexibility, and
  585.         it would be nice if interfaces were developed for the popular BBS
  586.         systems on the market today.
  587.  
  588.  
  589.                               ____________________
  590.  
  591.                               SETUP: CALL SECURITY
  592.                               ____________________
  593.  
  594.              Want to setup communications that will ALWAYS occur in a
  595.         specific manner, from a specific destination?  TCR can be setup to
  596.         RETURN the call to a specific phone number.  Some might not
  597.         understand the entire concept behind this, but it's become popular
  598.         where secure sessions are required (terminal programs such as
  599.         PcAnywhere provide the service amung others, for those who haven't
  600.         setup a BBS).
  601.  
  602.              Setup using the "BASIC" setup, and then make the following
  603.         changes:
  604.  
  605.              (1) Number changing should be set to OFF.  This will ensure
  606.                  that the number that TCR will be forced to callback
  607.                  cannot be changed.
  608.  
  609.              (2) Random Password checking should be turned OFF.  If the
  610.                  destination number is forced, there is no point for this
  611.                  extra security.  Regular password checking should be left
  612.                  ON.
  613.  
  614.              (3) Lock Previous should be OFF, such that this call-loop can
  615.                  be done at any given time without being told the process
  616.                  can't be completed because it's been done once (this is a
  617.                  multi-session setup in other words, not a one time
  618.                  thing).
  619.  
  620.              Now setup the BBS account to use the number that you wish to
  621.         dial back.  For this user account, the first thing that should
  622.         occur is a shell to TCR (before getting to the main menu - just
  623.         force the logon user into the door).  NOTE: THIS IS ONLY FOR THE
  624.         ONE CALLER, OR CALLERS, THAT YOU WISH TO HAVE TCR DO A SECURE DIAL
  625.         ON.  SETUP A SPECIAL SECURITY LEVEL IF NECCESSARY.  Now they have
  626.         no choice but to go through the door, and no choice but to use the
  627.         number in the user record for the dialback.  Now anyone logging on
  628.         under that account will be called back at a PRE-defined number,
  629.         which means that account can only be used from that PRE-defined
  630.         number.
  631.  
  632.  
  633.                           ________________________
  634.  
  635.                           MULTINODE CONSIDERATIONS
  636.                           ________________________
  637.  
  638.              The largest changes to the 1.10 version of TCR were the 
  639.         multinode considerations made in the program.  Multinode callback 
  640.         doors require different options & configurations for different 
  641.         nodes.  TCR verisons prior to 1.10 didn't take into consideration 
  642.         these requirements, and anyone installing TCR on a multinode system 
  643.         would have either run into problems or had to kludge their way to 
  644.         making it work.
  645.  
  646.              There are only a couple of changes that need to be made when 
  647.         running TCR in a multinode environment.  Firstly; the node number 
  648.         should be passed to the batch file TCR.BAT, so that the command 
  649.         line would be something similar to TCR.BAT <node#>.
  650.  
  651.              Once this has been done, only a few other changes need to be 
  652.         made.  The commandline for TCR must now include /#:%1 (which, 
  653.         translating from the batch command TCR.BAT <node#> would pass the 
  654.         node number to TCR from the batch file).
  655.         
  656.                   ...
  657.                   CD\BBS\TCR
  658.                   REM TCR /D:<path to DOOR.SYS>
  659.                -> TCR /#:%1 /D:<path to DOOR.SYS>
  660.                   CD\BBS
  661.                   ...        
  662.  
  663.              That's the first part that needs to be changed.  Any other 
  664.         sections which use the files SUCCESS.TCR and LONGDIST.TCR must also 
  665.         be changed.  When the /#:<node#> parameter is included, these files 
  666.         change from SUCCESS.TCR to SUCCESS.<node#> and LONGDIST.TCR to 
  667.         LONGDIST.<node#>.
  668.  
  669.                   ...
  670.                   CD\BBS\TCR
  671.                   TCR /#:%1 /D:<path to DOOR.SYS>            
  672.                   REM IF EXIST SUCCESS.TCR <command>
  673.                -> IF EXIST SUCCESS.%1 <command>
  674.                   REM IF EXIST LONGDIST.TCR <command>
  675.                -> IF EXIST LONGDIST.%1 <command>
  676.                   CD\BBS
  677.                   ...
  678.  
  679.              Lastly, each modem for each node will require a different 
  680.         setup file.  These files are called MODEM.<node#> and are created 
  681.         by the TCR SETUP procedure.  To define your various nodes modem 
  682.         configurations, run TCR SETUP /#:<node#> for each of the nodes that 
  683.         you operate on.
  684.  
  685.  
  686.                                    ________
  687.  
  688.                                    VERSIONS
  689.                                    ________
  690.  
  691.              This section will always contain the history/update information
  692.         on this program.  It will list a general summary of bug fixes and new
  693.         features.  Please read this section on every upgrade, even if you
  694.         don't plan on reading any other section.
  695.  
  696.                   +:New Feature   *:Updated (Fixed) Feature
  697.  
  698.                                    v1.00 Beta 01
  699.  
  700.          + Written in Turbo Pascal v6.0.
  701.          + First release to the general public.
  702.  
  703.                                    v1.00 Beta 02
  704.  
  705.          If you are upgrading from Beta 01, delete your TCR.CFG file and run
  706.          TCR SETUP again to create the larger .CFG file used in Beta 02.
  707.  
  708.          There are probably many more changes then this, I just don't
  709.          remember them all at this point.  Things have been hectic around
  710.          here lately, and work on TCR has been progressing for the last 2
  711.          months -- mostly in the last few days -- but I still don't remember
  712.          all that has been done. ;)
  713.  
  714.          + Added password feature (optional)
  715.          + Added random password feature (optional)
  716.          + Changed connection detection so that connect ends loop
  717.          + Added log file
  718.          + Lockout number now checked after user input
  719.          + Added long distance callbacks - can be toggled off, or during
  720.              specified time windows only
  721.          * Phone number sent to TCR-LOCK.DAT file didn't have the 1- part of
  722.              the number, so no entries would be locked out properly.
  723.          + Added TCR-LONG.DAT gives LD numbers that can be called
  724.          + Added TCR-CALL.DAT which stores previously called systems.  If you
  725.              are using TCR as a call return door (one-way LD systems for
  726.              instance), then you should leave LOCK PREVIOUS set to OFF.
  727.          + Various new display files:
  728.  
  729.                 TCR-BAD  Displayed to users who fail password checks
  730.                 TCR-OK   Displayed to users after successful call return
  731.                 TCR-LONG Displayed to users who are LD if LD calls are off,
  732.                            or number can't be called (not in TCR-LONG.DAT)
  733.                 TCR-TIME Displayed to users who are LD, and the current time
  734.                            is not during a LD calling time window.
  735.  
  736.  
  737.                                    v1.00 Beta 03
  738.  
  739.          If you are upgrading from Beta 02 or Beta 02, then you will need
  740.          to delete your TCR.CFG file, and then run TCR SETUP to create
  741.          the larger configuration file.
  742.  
  743.          I don't remember all of the changes to this version (it's been 4+
  744.          months in production, and my notes have since been lost), but I
  745.          will say this -- it works far better with the modem now then it
  746.          used to.  I added a lot of delays, etc into the code to try and
  747.          clean it all up and ensure that the modem responses were handled
  748.          better.  TCR also now times itself out if the init doesn't work.
  749.  
  750.          The path is also specified now on the command line, which might
  751.          make it easier for most people to use.  The format is TCR <path
  752.          to DOOR.SYS> - ie, TCR C:\BBS\ would load the DOOR.SYS file in
  753.          C:\BBS\.
  754.  
  755.          Other then that, play a bit and see how it works.
  756.  
  757.  
  758.                                   v1.10 Beta 01
  759.  
  760.          If you are upgrading from a previous version of TCR, please delete 
  761.          the TCR.CFG file since it is no longer being used (replaced by 
  762.          node dependant modem information files).
  763.  
  764.          TCR should now handle multinode setups a LOT better.  The new 
  765.          command line /#:<node#> should be included with all multinode 
  766.          setups.  This will use a different modem definition file 
  767.          (MODEM.<node#>) instead of the standard MODEM.TCR file, and will 
  768.          use temporary log files so the main log doesn't get corrupted (or 
  769.          filled with entries at different times from different nodes).  
  770.          Including this command will also create multiple success files 
  771.          (SUCCESS.<node#> and LONGDIST.<node#>).  PLEASE READ THE SECTION 
  772.          ENTITLED MULTINODE CONSIDERATIONS SINCE IT OUTLINES ALL THE 
  773.          CHANGES THAT ARE NECCESSARY FOR YOU TO COMPLETE.
  774.  
  775.          The method to include the DOOR.SYS path has changed to /D:<path> 
  776.          instead of just including the <path> on the command line.
  777.          
  778.          Some fossil routine problems have also been fixed up in hopes that 
  779.          some of the weird things (hangs, FAT damages) etc are cleaned up.  
  780.          Some parts of higher memory would inadvertently be wiped out when 
  781.          first running TCR, which wouldn't cause problems when nothing was 
  782.          loaded in this memory, but would if something was.
  783.  
  784.                                v1.10 Beta 02
  785.  
  786.          Minor changes.
  787.  
  788.          /D: directory command was only accepting first 6 characters.  
  789.          Should now work to a length of 65 characters.
  790.  
  791.          If number changes were OFF, numbers weren't being written to
  792.          TCR-CALL.DAT, which was a problem.  Fixed.
  793.  
  794.  
  795.                                   __________
  796.  
  797.                                   LEGALITIES
  798.                                   __________
  799.  
  800.          WARRANTY
  801.  
  802.                 TCR is provided as-is, without a warranty of any kind, either
  803.            expressed or implied.  It is only guaranteed to occupy disk space,
  804.            nothing more.  Under no circumstances shall the author be liable
  805.            to you or anyone else for any damages, including (but not limited
  806.            to) any lost profits, lost savings or other incidental or
  807.            consequential damages arising out of the use or misuse of this
  808.            program.
  809.  
  810.                 In other words; RUN THIS PROGRAM AT YOUR OWN RISK.  You
  811.            yourself, and nobody else is responsible for the outcome of
  812.            choosing to run this program.
  813.  
  814.  
  815.          COPYRIGHT
  816.  
  817.                The program, and all documents and files included in the
  818.            original TCR release package are copyrighted to Tim Strike and
  819.            Forbidden Knights Systems.  They are not to be modified in any
  820.            way, shape or form;  The distribution archive may be changed from
  821.            ARJ/ZIP to another archive form, as long as no files are added or
  822.            removed from the release archive.
  823.  
  824.                 TCR may be packaged on a distribution diskette or in a
  825.            compilation archive, but under no circumstances may any charge be
  826.            incurred beyond the physical cost of the hardware (disks, CD...)
  827.            or trasfer medium (phone, mail...).
  828.  
  829.  
  830.          CREDITS
  831.  
  832.                 All brand and product names referenced in this document are
  833.            trademarks, registered trademarks, or copyrighted works of their
  834.            respective holders.
  835.  
  836.  
  837.                               _____________________
  838.  
  839.                               CONTACTING THE AUTHOR
  840.                               _____________________
  841.  
  842.  
  843.              I can be contacted in a number of different methods.  When
  844.         sending netmail or posting in one of the conferences, direct mail to
  845.         "Tim Strike".  Replies will be forthcoming as soon as I can get to
  846.         them.
  847.  
  848.         NETMAIL:
  849.  
  850.             Telenet Canada      Fidonet        Xnet           ITCnet
  851.             20:22/101           1:259/423      40:41/108      85:896/521
  852.  
  853.         ECHOMAIL CONFERENCES:
  854.  
  855.             TNC_BBS         BBS Support                             (TNC)
  856.             TNC_FKNIGHTS    Forbidden Knights Support               (TNC)
  857.  
  858.         POSTAL MAIL:
  859.  
  860.             Forbidden Knights Systems
  861.                 Attn: Tim Strike
  862.             3360 Council Rind Rd, Unit 11
  863.             Mississauga, ON
  864.             L5L 2E4
  865.  
  866.         BULLETIN BOARD:
  867.  
  868.              Forbidden Knights Systems
  869.              (905)820-7273
  870.              2400-16,800 Courier Dual Standard
  871.              Access denied between 4:00am and 5:00am
  872.              Restricted access between 9:00pm and 10:00pm
  873.  
  874.  
  875.              Any changes or upgrades that need to be made to TCR v1.10 will
  876.         be made as time permits.  Further suggestions, comments and/or bug
  877.         reports can be directed through one of the above methods.
  878.  
  879.                                                           Enjoy fully.
  880.  
  881.